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Package com. xis. types 

This package contains classes that provide several standard TypeMetaData classes for describing types and their 
constraints, and for rendering and editing values of those types. 



See: 

Description 



Interface Summary 


Data Tost 


Thp nntnTp^f infprfnrp QnprifiPQ mpthrwl« fnr Ohip^i - vnliHrrfinn 




Thlc Infprfnr'P rfpfinpo fhp TO frvr WTIUtt 


Summary Function 


The SummaryFunction interface defines generic summary functionality based upon provided 
incut data vciIup*? 


SwingTypelO 


Thp ^winnTvnpTfi intprfnr'P nllrtw^ fnr fhp iiqp nf hnfh Qwlnn pHifnrc niinu/inn cu/Inn 
nic on ii ly lypciv iiilci iu^c uuuwo uic use \ji uuui owiiiy cukui a, uiiurfMiy owiny 

components to edit an object, and swing Tenderers, which know how to render these objects 
in a swing environment. 


TextTypelO 


The TextTypelO interface provides a means of formatting objects in a textual fashion, as well 
as parsing text from which an object is created. 


TvpedValue 


The TypeValue interface is used to hold an object that carries its own TypeMetaData with 
it. 


TvveEditor 


The TypeEditor interface defines methods for editing attributes provided by the types 
implemented within this package. 


TvvelO 


The TypelO interface provides a common base from which other TypelOs can extend, such as 
HTMLTypelO, SwingTypeIO,etc. 


TypeMetaData 


The TypeMetaData interface defines generic type accessors for object comparing, editing, 
formatting, rendering, and validation. 


TvpeMetaDataFactorv 


The TypeMetaDataFactory interface defines a class that can create TypeMetaData for a 
given Class Type. 


TvpeRenderer 


The TypeRenderer interface defines methods for rendering attributes provided by the types 
implemented within this package. 


ValidTestProxv 


The ValidTestProxy interface. 


WMLTvpeEditor 


The WMLTypeEditor interface defines methods for rendering attributes provided by the types 
implemented within this package. 


WMLTypeJO 


This interface defines the 10 for WML format. 


WMLTypeRenderer 


The WMLTypeRenderer interface defines methods for rendering attributes provided by the 
types implemented within this package. 


XMLTvvelO 


The XMLTypelO interface provides a means of formatting objects in a XML textual fashion, as 
well as parsing XML text for creating an object. 
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Class Summary 


AbstractDataTest 


The AbstractDataTest class Drovides a default imDlementation of fp^t 
(Object) 


AbstractTypeMetaData 


AbstractTypeMetaData provides a partial implementation of 
TypeMetaData to relieve the XIS developer from explicitly implementing 
irrelevant methods. 


AreaOfUncertaintyTypeMetaData 


AreaOfUncertaintyTypeMetaData is a type object that supports 
AreaOfUncertainty objects. 


ArrayListTypeMetaData 


ArrayListTypeMetaData is a type object that supports 
java.utilArrayList objects. 


ArrayTypeMetaData 


ArrayTypeMetaData is a type object that supports java.lang.reflectArray 
objects. 


BeanTypeMetaData 


BeanTypeMetaData is a type object that supports java.beans objects. 


BooleanTypeMetaData 


The BooleanTypeMetaData is a type object that supports Boolean objects. 


BooleanTypeMetaDataFactory 


A BooleanTypeMetaDataFactory can create a 
BooleanTypeMetaData for given booleans. 


CachedTypeMetaData 


CachedTypeMetaData is a type object that simply delegates all 
TypeMetaData calls to another TypeMetaData. 


ClassificationTypeMetaData 


ClassificationTypeMetaData is a type object that supports 
Classification objects. 


CollectionsTypeMetaData 


CollectionsTypeMetaData is a type object that supports Collection 
objects. 


ColorTypeMetaData 


The ColorTypeMetaData class implements TypeMetaData for Color 
objects. 


ColorTypeMetaDataFactory 


A ColorTypeMetaDataFactory can create a ColorTypeMetaData for 
a given Color object. 


ConversionNumericTypeMetaData 


A generic NumericTypeMetaData for converting from one unit to another. 


CurrencyTypeMetaData 


CurrencyTypeMetaData is a type object that supports Number objects 
that represent Currency values. 


DateTimeTypeMetaData 


DataTimeTypeMetaData is a type object that supports Date objects. 


DataTimeTypeMetaDataFactory 


A DateTimeTypeMetaData Factory can create a 
DataTimeTypeMetaData for given Date objects. 


DiscreteRangeStringTypeMetaData 


DiscreteRangeStringTypeMetaData is a type object that supports 
String objects with discrete ranges. 


DisplayLabelTypeMetaData 


DisplayLabelTypeMetaData is a type object that supports 
DisplayLabel objects 


DTGTypeMetaData 


DTGTypeMetaData is a type object that supports Date objects. 


EnumerationType 


Class to implement an enumeration in Java. 


EnumerationTypeMetaData 


The EnumerationTypeMetaData class is used to represent integer 
constants as strings to the user. 


FontTypeMetaData 


FontTypeMetaData is a type object that supports Font objects. 


HashMapTypeMetaData 


HashMapTypeMetaData is a type object that supports java.util.HashMap 
objects. 
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HashSetTypeMetaData 


HashSetTypeMetaData is a type object that supports java:u%HashSet ,f 
objects. J - '*,s t ,\ ?0y" 


IconShapeTypeMetaData 


IconShapeTypeMetaData is a type object that supports IconShape 
objects. 


IconTypeMetaData 


IconTypeMetaData is a type object that supports Icon objects. 


LinkedListTypeMetaData 
ListTypeMetaData 


LinkedListTypeMetaData is a type object that supports 
jQva.util.LinkedUst objects. 


MouseMapProxy 


ListTypeMetaData is a type object that supports javoMtiflist objects. 

The MouseMapProxy class allows TypeEditors access to the map without 
requiring them to having any compile time knowledge of the map's 
existence. 


NumberComparator 


An implementation of the Comparator interface that compares two objects 
that extend Number, or that both implement Comparable, with the class of 
one assignable from the other. 


NumericTypeMetaData 


NumericTypeMetaData is a type object that supports Number objects. 


numeric lypeMetauatar actory 


n MUMiciiv,iyyeMeiuuuiaraciory can create Numeric lypeMetaData 
for a given class type or method return type. 


ObjectTypeMetaData 


ObjectTypeMetaData is a type that supports a simple Object and is 
provided to quickly add arbitrary attribute types to a Data Source Interface 
without writing a more specific type handler. 


PercentTypeMetaData 


PercentTypeMetaData is a type object that supports Number objects that 
itpicacia r ci ucr vaiues. 


ProbabilityTypeMetaData 


ProbabilityTypeMetaData is a type object that supports Number 
objects that represent Probability values. 


r\c(iamea lypeMeiauaia 


RenamedTypeMetaData simpfy delegates all TypeMetaData calls to 
another TypeMetaData except for the getNameQ, which is overridden with 
the aiven vnlnp 


ResizedTextTypeMetaData 


ResizedTextTypeMetaData simply delegates all TypeMetaData calls to 
another TypeMetaData except for the getPixeWdthQ, which is overridden 
with the given value. 


Resources 


The Resources class is automatically generated and must be public, but it 
is intended to be used only by Java's internationalization support classes. 


SmartDurationTypeMetaData 


A SmartDurationTypeMetaData for converting from one time unit to 
another based on the magnitude of the duration value. 


StringTypeMetaData 


StringTypeMetaData is a type object that supports String objects. 


StringTypeMetaDataFactory 
TextTypeM eta Data 


A StringTypeMetaDataFactory can create a StrinaTvnpMptnnntn 
for a given String object. 


TypedValueTypeMetaData 


TextTypeMetaDota \s a type object that supports Text objects. 

TypedValueTypeMetaData is a type object that supports 
TypedValue objects. 


TypedEditorBeanContextChiidSupport 


The TypeEdjtorBeanContextChiidSupport class handles most of the 
responsibilities of a TypeEditor and a BeanContextChild. 


TypedEditorSupport 


The TypeEditorSupport class handles most of the responsiblities of a 
TypeEditor. 


TypelOPIuggableService 


The TypelOPIuggableService class is responsible for loading TypelOs. 


TypelORegistry 


The TypelORegistry class is a registry for different implementations of 
TypelO classes. 
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TypelOSupport 


The TypelOSupport provides support TypeMetaData's get TypelO 
methods. 


TypeMetaDataDelegator 


TypeMetaDataDelegator is a type object that simply delegates all 
TypeMetaData calls to another TypeMetaData. 


TypeMeta Data Factory PtuggableService 


The TypeMeta DataFactoryPluggableService class is responsible for 
loading TypeMetaDataFactories. 


TypeMetaDataFactoryStore 


This Class stores TypeMetaDataFactories. 


TypePreferences 


This class is used by TypeMetaData instances to pass information about 
preferred TypeMetaData objects. 


Types 


The Types class is a holder class for the RESOURCES global variable for 
resource properties of the com.xis.types package. 


URLTypeMetaData 


URLTypeMetaData is a type object that supports URL objects. 



Exception Summary 


NoSuchEnumerationException 


Class to implement an enumeration exception in Java. 


ParseFailedException 


A ParseFailedException is thrown (typically by TypelO objects) when it is not 
possible to parse a given String as described. 


TestFailedException 


The TestFailedException is thrown from the n test() w method of a DataTest 
subclass when the value fails the test. 



Package com.xis.types Description 

This package contains classes that provide several standard TypeMetaData classes for describing types and their 
constraints, and for rendering and editing values of those types. 
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HeHoWorld.java 

P XIS Tutorial standalone sequence example 1 data class. */ 

public class HelloWorld { 
private float value = 1.5f; 

public String toString() { 
return "Hello World!"; 

} 

public int getlD() { 
return 5; 

} 

public float getValue() { 
return value; 

} 

// uncomment this to make "value" editable 

r 

public void setValue(float value) { 
this.value = value; 

} 

7 



} 
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TestHamess.java 



> 



1602 



r XIS Tutorial standalone sequence example 1 XIS interfacing. */ 
import javax.swing. JFrame; 
import java.awtevent.WindowAdapter; 
import java.awteventWindowEvent; 
import com.xis.propertysheetPropertySheetlnfoBean; 
import com,xis.ui.UIBeanEvent; 
import coiuxis.ui.UIBeanAdapter; 
import comjdsJeif.im.BaselnfoModel; 

public class TestHarness { 

public static void main(StringQ args) { 

// the plugin manager is only required for more complex applications 
// involving multiple components integrated at runtime 
BaselnfoModel.setStartingPluglnManager(false); 

// a property sheet infobean to display HelloWorld's attributes 
PropertySheetlnfoBean properties = new PropertySheetlnfoBean(); 
properties.addRawDataltem(new HelloWoiidQ); 



> 1604 



Y 1606 



// add listener for 'OK/ 'cancel/ or close, which generate 'close' events ^ 
properties.addUIBeanListener( 
new UIBeanAdapterQ { 

public void closed(UIBeanEvent event) { 
System.exit(O); 

} 

} 

); 



y 1608 



// a top-level frame to hold our property sheet infobean 
JFrame frame = new JFrame("HeIIoWor!d Properties"); 
// add a listener for window closing 
frame.addWindowListener( 
new WindowAdapterQ { 

public void windowClosing(WindowEvent e) { 
System.exit(O); 

} 

} 

); 



r 1610A 
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Continuation of T estHarness.f ava 

II stick the bean in the frame and display it 

£me^ 
frame.setVisible(true); 
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HelloWorld.java 

/* XIS Tutorial standalone sequence example 2 data class. */ 
/*{*/ 

import java.awt Color; 

import java.beans. PropertyChangeSupport; 

import java.beans.PropertyChangeListener; 

/*}*/ 

public class HelloWorld { 
/*{*/ 

private int value = 1 ; 

private Color myCoIor = Color.green; 



// this member class helps distribute property change events within XIS 
private PropertyChangeSupport propertyChangeSupport = 
new PropertyChangeSupport(this); 

// two aux methods to let other XIS objects pay attention to this one 
public void addPropertyChangeListener(PropertyChangeListener I) { 
propertyChangeSupport.addPropertyChangeListener(l); 

} 

public void removePropertyChangeListener(PropertyChangeListener I) { 
propertyChangeSupport. removePropertyChangeListener(l); 



public String toString() { 

return "A HelloWorld Object"; 

} 

public String getGreeting() { 
return "Hello World!"; 

} 

In*/ 

public int getlD() { 
return 5; 

} 
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....... x ..v 



Continuatio n of of HeHoWorid.iava 



public /T/int/y/getValue(){ 
return value; 

} 



/*{*/ 



1808< 



1810< 



} 



public void setVa!ue(int value) { 

* ^s^sssr^ H m ,s reaiiy a * an9e 

int oldValue = this, value; 
this.value = value; 

// fire property change event to notify other XIS objects 1 
propertyChangeSupport.firePropert^ChangervaE vatue); j 



} 



1804 



public Color getMyColorO { 
return myColor; 

public void setMyColor(Color myColor) { 

Color oldMyColor = this.myColor; 
th is . myColor = myColor; 

mZT?^ ° I 3 " 96 e * ent t0 notif y other XIS objects 
propertyChangeSupport.firePropertyChange("myColor" 
oldMyColor, myColor); 



} 

ryi 



} 



1804 



} 
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TestHarness.java 

/* XIS Tutorial standalone sequence step 2 XIS interfacing. */ 

import javax.swing.JFrame; 
import java.awteventWindowAdapter; 
import java.awt.event.WindowEvent; 

import com.xis.propertysheet.PropertySheetlnfoBean; 
import com.xis.ui.UIBeanEvent; 
import com.xis.ui.UIBeanAdapten 
import com.xis.leif.im.BaselnfoModei; 
/*{*/ 

import jclass.chart. JCChart; 
import com.xis.plotPlotlnfoBean; 
import com.xis.plot.chartviews.LeifChartView- 
/*}*/ 

public class TestHamess { 

public static void main(String[| args) { 

// the plugin manager is only required for more complex applications 
// involving multiple components integrated at runtime 
BaselnfoModel.setStartingPluglnManager(false); 

HelloWorld hello = new HelloWorldQ; 

II a property sheet infobean to display HelloWorld's attributes > 1 902 

PropertySheetlnfoBean properties = new PropertySheetlnfoBeanfV 
properties.addRawDataltem(hello); 

// add a listener for 'OK' or 'cancer, which generate 'close' events 
properties.addUIBeanListener( 
new UIBeanAdapterQ { 
public void closed(UIBeanEvent event) { 
System.exit(O); 

} 

} 

); 



FIG. I9A 



Title: Extensible Information System (XIS) 
Inventors: R.Kadeletal. 
Appl.No.: 10/039,306 -Filed: 10/22/01 
28/90 



Continuation of TestHarness.java 



II a top-level frame to hold our property sheet infobean 
JFrame propertySheetFrame = new JFramefHelloWorld Properties"); 
// add a listener for window closing 
propertySheetFrame.addWindowListener( 
new WindowAdapter() { 

public void windowClosing(WindowEvent e) { 
System.exit(O); 

} 

} 

): 

// stick the property Sheet bean in the frame and display it 
propertySheetFrame.getContentPane().add(properties); 
propertySheetFrame.packO; ^1904 
propertySheetFrame.setVisible(true); 

f = // now we create a plot infobean to plot HelloWorid's numeric attribute 

f PlotlnfoBean plot = new PlotlnfoBean(); 
iy06 1 p!ot.addRawDataltems(new ObjectQ { hello }); 
plot.setChartType(JCChart.BAR); 

// the alternatives are SCATTER_PLOT, PLOT, AREA, PIE. CANDLE, 
// and STACK1 NG_B AR, though not all will make sense in this example 

// a top-level frame as before to hold our property sheet infobean 
JFrame plotFrame = new JFrame("HelloWorld Plot"); 

// stick the plot bean in and put it up 
plotFrame.getContentPaneQ.add(plot); 
plotFrame. pack(); 
plotFrame.setVisible(true); 

/*}*/ 
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HelloWorldjava 

T XIS Tutorial standalone sequence step 3 data class. 7 
import java.awt. Color; 

// (property change support moved to HelloWorldTransIator) 

public class HelloWorld { 
private int value = 1 ; 
private Color myCoior = Color.green; 

public String toStringQ { 

return "A HelloWorld Object"; 

} 

public String getGreeting() { 
return "Hello World!"; 

} 

public int getlDQ { 
returns; 

} 

public int getValue() { 
return value; 

} 

/*{7 

public void setValue(int value) { 

// ail the worrying about change events is moved to the translator, 
// so we just need to do the bare change operation (unless nonXIS 
// components need to listen to PropertyChanges) 
this .value = value; 

} 

ryi 

public Color getMyColorQ { 
return myCoior; 

} 

ret 

public void setMyColor(Color myCoior) { 
// just need to set the value (see setValueQ) 
this.myColor = myCoior; 

} 

ryi 
} 



FIG. 2 1 



Title: Extensible Information System (XIS) 
Inventors: R. Kadel et al. J ' . 

Appl.No.: 10/039,306 -Filed: 10/22/01 A !\ ^fr" 

31/90 v-'. 



HetloWoridTranslatorjava 

I* XIS Tutorial standalone sequence step 3 data translator class. 7 
/*{*/ 

import com.xisJeif.tm.AttributeGetRequest; 

import com.xis.leif.im.AttributeSetRequest; 

import com.xis.Ieif.im.Domain; 

import com.xis.ieif.im.Translator; 

import com.xis.Ieif.im.FieldMetaData; 

import com.xis.domains.dispIay.DisplayDomain; 

import com.xis.domains.movement.MovementDomain; 

import java.awt.Color; 



m public class HelloWorldTranslator extends Translator { 

// the domains from which canned attribute metadata will be taken 
2202^ " NOTE, if an attribute appears in the methods below but its domain 

// is NOT listed here, THE ATTRIBUTE WILL BE IGNORED BY XIS 
private static final DomainQ baseDomains = new DomainQ { 
DisplayDomain.getDomainO, MovementDomain.getDomainQ 

}» 



2203< 



2204 



{ 



// store info about the fields, such as whether they are preferred or not 
private Field Meta Da taQ field MetaDataArray; 

// Return the Domains that describe the Attributes, 
public DomainO getBaseDomainsQ { 
return baseDomains; 

} 



// this method returns info on each field defined in the methods below 
-public FieldMetaDataQ getFieldMetaDataArrayQ { 

if (fieldMetaDataArray == null) { 

// initialize default metadata 
FieldMetaData dispname = new 

FieldMetaData(DisplayDomain.displayName); 
FieldMetaData pencolor = new 

FieIdMetaData(DisplayDomain,penColor); 
FieldMetaData speed = new 

FieldMetaData(MovementDomain.speed); 
FieldMetaData course = new 

FieldMetaData(MovementDomain.course); 
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} 



Continuation of HelloWortdTranslator.java 

// attributes are visible ('preferred') by default; this 
// turns this off for the course attribute. 
course.setVisibility(false); 

// the order we put the attributes in here determines the order 
// they appear in tables or property sheets 
fieldMetaDataArray = new FieldMetaDataQ { 
dispname, speed, course, pencolor 

}; 

} 

return fieldMetaDataArray; 
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llllllllllllilllllllllllllllllllllllllllllillllllllltlllillllllllll 
II the following methods expose attributes of the HelloWorld class; 
// instead of calling the class methods directly, XIS will access 
// everything through this translator class 

lllllllllllllllllllllllllinilllllllllllllllllllllllllllllllllinil 

public String getDisplayName(AttributeGetRequest attributeGetRequest) { 
return ((HelloWorld) 

attributeGetRequest.getRawDataltem()).toStringO; 

} 

public Color getPenColor(AttributeGetRequest attributeGetRequest) { 

return ((HelloWorld) 

attributeGetRequest.getRawDataltem()).getMyColor(); 

} 

public void setPenColor(AttributeSetRequest attributeSetRequest, ^ 22 1 0 

Color penColor) { 
HelloWorld helloWorld = (HelloWorld) 

attributeSetRequestgetRawDataltemO; 
Color oldPenColor = helloWorld.getMyColor(); 
if (!penColor.equals(oldPenColor)) { 
helloWorld.setMyColor(penColor); 
// fire property change event to notify other XIS objects 
attributeSetRequest.getBaseDataltem().fireAttributeChanged( 

DisplayDomain.penColor, oldPenColor, penColor, true); 

} 

} 

public double getSpeed(AttributeGetRequest attributeGetRequest) { 
return (double) ((HelloWorld) 

attributeGetRequest.getRawDataltem()).getValue(); 

} 
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Continuation of HelloWorldTranslator.fava 

public void setSpeedfAttributeSetRequest attributeSetRequest 

double speed) { 
HelloWorld helloWorld = (HelloWorld) 
n u, , Je , attriD uteSetRequest.getRawDataltem(); 
Double oldSpeed = new Double((double)heiloWortd.getValueOV 
if (oldSpeed.doubleValue() != speed) { 
hello World.setValue((int)speed); 

// fire property change event to notify other XIS objects | 

attnbuteSetRequest.getBaseDataltem().fireAttributeChanged( 
MovementDomain.speed, oldSpeed, new Double(speed), true); 

} 

// this is a dummy attribute to demonstrate field metadata 
^n^^^^^^^ 90 ^" 691 attribute GetRequest) { "2208 

/*{*/ 

// uncomment this to allow reflection to expose additional attributes 

// (see documentation under "Fooling Around") 

// public HelloWoridTranslatorQ { 

// ^ introspectExcept(new StringfJ {"value", "myColor"}); 

ryi 

} 
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TestHarness.java 

r XIS Tutorial standalone sequence step 3 XIS interfacing. */ 

import javax.swing J Frame; 
import java.awt.event.WindowAdapter; 
import java.awt.event.WindowEvent; 
import com.xis.propertysheetPropertySheetlnfoBean; 
import com.xis.ui.UIBeanEvent; 
import com.xis.ui.UIBeanAdapter; 
import com.xis.leif.im.BaselnfoModel; 
import jclass.chart JCChart; 
import com.xis.plot.PlotlnfoBean; 
import com.xis.plotxhartviews.LeifChartView; 
/*{7 

import com .xis . leif .im .TransIatorRegistry ; 
import com.xis.leif.im.LeifDataltem; 
import com.xis.leif.im.InfoModel; 
import com.xis.leif.im.BaselnfoModel; 
import com.xis.domains.movement.MovementDomain; 
import com.xis.domains.movement.MovementDomainWrapper; 
import com.xis.leifJm.LeifDataltemDelegator; 
import java.lang.reflect.lnvocationTargetException; 
import com.xis.leif.im.UndefinedLeifAttributeException; 

/*}*/ 

public class TestHarness { 
/*{*! 

protected static LeifDataltem leifHello; 
static { 

// Register the translator for HelloWorld. In fact this is really 
// only necessary when we have not followed the standard naming 
// convention (see docs), but it can't hurt. 

TranslatorRegistry.getTranslatorRegistry().registerObjectSchema( 
HelloWorld.class, HelloWorldTranslator.class); 

} 

ryi 

public static void main(StringQ args) { 

// the plugin manager is only required for more complex applications 
// involving multiple components integrated at runtime 
BaselnfoModel.setStartingPlugtnManager(false); 

HelloWorld hello = new HelloWorldQ; 
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Continuation of TestHarness.java 



// a property sheet infobean to display HelloWorid's attributes 
PropertySheetlnfoBean properties = new PropertySheet!nfoBean(); 
properties.addRawDataltem(hello); 

// add a listener for 'OK' or 'cancel', which generate 'close' events 
properties.addUIBeanListener( 
new UIBeanAdapter() { 

public void closed(UIBeanEvent event) { 
System.exit(O); 

} 

} 

); 

// a top-level frame to hold our property sheet infobean 
JFrame propertySheetFrame = new JFramefHelloWorld Properties"); 
// add a listener for window closing 
propertySheetFrame.addWindowListener( 
new WindowAdapter() { 

public void windowClosing(WindowEvent e) { 
System.exit(O); 

} 

} 

); 

// stick the property Sheet bean in the frame and display it 
propertySheetFrame.getContentPane().add(properties); 
propertySheetFrame.pack(); 
propertySheetFrame.setVisible(true); 
// now we create a plot infobean to plot HelloWorid's numeric attribute 
PlotlnfoBean plot = new PlotlnfoBean(); 
plot.addRawDataltems(new ObjectQ { hello }); 
pIot.setChartType(JCChart.BAR); 

// the alternatives are SCATTER_PLOT, PLOT, AREA, PIE, CANDLE. 
// and STACKING_BAR, though not all will make sense in this example 

// We can set the attribute for initial display on the plot; 

// if we do, this must consist of the attribute name preceded 

// by the fully-qualified classname which ORIGINALLY DEFINES 

// the attributeDescriptor - i.e., using "HelloWorld.speed" 

// here will NOT work! If the descriptor is not defined in a 

// domain or translator class, then it will have been defined 

// dynamically through introspection when the first instance 

// of the data item is dropped into an XIS InfoBean. 

plot.setYAxisAttribute( 

M com.xis.domains,movement.MovementDomain.speed M ); 
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Continuation of TestHarness.java 

plotsetDynamicAdjustment(true); // so axes track value magnitude 
plotsetBarChartAdjusting(true); // needed in some cases for bar chart 

// a top-level frame as before to hold our plot infobean 
J Frame plotFrame = new JFramefHelloWorld Plot"); 

// stick the plot bean in and put it up 
plotFrame.getContentPaneQ.add(plot); 
pIotFrame.pack(); 
plotFrame.setVisible(true); 

/*{7 

// create a leifDataltem version of hello and start a thread that 
// will increase it 
leifHello = 

BaselnfoModel.getBaselnfoModel().getLeifDataltem(hello); 
new Accelerate(); 

ry/ 

} // main 

} 

r{7 

// thread to update the speed attribute on the leifHello instance we created 
class Accelerate extends Thread { 

public Accelerate() { 

super( f, Accelerator Thread"); 
start(); 

} 

public void run() { 

// wrap the LeifDataltem leifHello in a convenience wrapper that 
// gives access to attributes within that domain, if they exist 
MovementDomainWrapper helloMovementWrapper = 
MovementDomain.takeWrapper(TestHamess.leifHello); 
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Continuation of TestHarness.java 



while (true) { 

// sleep for 0.5 seconds, then... 
try{ 

sleep(500); 
} catch (InterruptedException e) { 

System.exit(l); 

} 

// ..update the speed attribute 
try { 

hefloMovementWrapper,setSpeed( 

heIloMovementWrapper.getSpeed()+l); 

} catch (UndefinedLeifAttributeException ulae) { 
// exception if this data item doesn't have this attribute 
System.exit(l); // usually we would do something better 

} catch (InvocationTargetException ite) { 
// sweep up any exception tossed by the underlying raw item 
System.exit(1 ); // usually we would do something better 

}// while 
} // run() 
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HelloWorldjava 

/* XIS Tutorial standalone sequence step 4 data class. 7 



import java. 
/*{7 

import com. 
import com. 
import com. 
import com, 
import com, 
import com 
import com 
import java, 
import java. 

ryi 



awtColor; 

.xis.leif.im.FieldMetaData; 

.xis.domains.display.DisplayDomain; 

.xis.domains.movement.MovementDomain; 

.xis.leif.im.Domain; 

.xis.leif.im.AttributeGetRequest; 

.xis.Ieif.im.AttributeSetRequest; 

.xisJeifJm.AttributeDescriptor; 

.beans.PropertyChangeSupport; 

.beansPropertyChangeListener, 



public class HelloWorld { 

private int value = 1 ; 
private Color myColor = Color.green; 

/*{*/ 

public static AttributeDescriptor getDisplayNameDescriptor() { 

return DisplayDomain.displayName; 
} ^2502 
public static AttributeDescriptor getSpeedDescriptor() { 

return MovementDomain.speed; 

} 

public static AttributeDescriptor getPenCoiorDescriptor() { 
return DisplayDomain.penColor; 

} 

ryi 

/*{7 // this property change support code as in step 2 /*}7 

// this member class helps distribute property change events within XIS 
private PropertyChangeSupport propertyChangeSupport = 

new PropertyChangeSupport(this); 

// two aux methods to let other XIS objects pay attention to this one 
public void addPropertyChangeListener(PropertyChangeListener I) { 
propertyChangeSupport.addPropertyChangeListener(l); 

} 

public void removePropertyChangeListener(PropertyChangeListener I) { 
propertyChangeSupport.removePropertyChangeListener(l); 

} 
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Continuation of HeHoWorld.f ava 

public String toString() { 

^ return "A HelloWorid Object"; 

public String getGreeting() { 

return "Hello World!"- 
} " ? 

public int getlDQ { 
return 5; 

} 

public int getValueQ { 
return value; 

/*{*/ // this function as in step 2 /*}7 
public void setVaiue(int value) { 

» JE3Ci?S£Sr and " re property change '" really 

int oldValue = this.value; 
this, value = value; 

tlZT 3 ^ ^e? nge event t0 notif y other X| S objects 
} PrapertyChangeSupport.firePropertyChange("value", oldValue. value); 

} 

/*{*/ 

// "myColorVelated methods changed to expose "penColor instead 

public Color getPenColor() { 
return myColon 

} 

public void setPenColor(Color penColor) { 

Color oldPenColor = this.myColor; 
this.myColor = penColor; 



} 

} 



// fire property change event to notify other XIS objects 

propertyChangeSupport.firePropertyChange("penColor" 

oldPenColor, penColor); 
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Continuation of HeHoWorld.java 

// expose toStringO return under a new name 
public String getDisplayName() { 
return toString(); 

// expose "value" under a new name 
public double getSpeed() { 
return (double) getValue(); 

public void setSpeed(double speed) { 

n W t, 0n, ^o ant t0 Update and fire P r °P ert y chan 9e if really changes 
Double oldSpeed = new Double((double)this.getValue()V 
if (speed != oldSpeed.doubleVa!ue()) { 
setValue((int)speed); 

// fire property change event to notify other XIS objects 
propertyChangeSupport.firePropertyChangeCspeed w , oldSpeed, 

new Double(speed)); 

} 

It store info about the fields, such as whether they are preferred or not 
pnvate static FieldMetaDataO fieldMetaDataArray; 

// this method returns info on each field defined in the methods below 
public static FieldMetaDataO getReldMetaDataArray() { 

if (fieldMetaDataArray == null) { 
// initialize default metadata 
FieldMetaData dispname = new 

FieldMetaData(DispIayDomain.displayName): 
ReldMetaData pencolor a new 

FieldMetaData(DisplayDomain.penColor); 
FieldMetaData speed = new 

FieldMetaData(MovementDomain.speed)- 
// could customize the field metadata here 
fieldMetaDataArray = new FieldMetaDataO { 
dispname, speed, pencolor 
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} 



}; 



} 

/*}*/ 
} 



return fieldMetaDataArray; 
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Class ContentlnfoBean 

+- — iavQ.qwtCo mpo nent 

+"iqyq.awt. Container 

+ — com.xis.ui.AbstractUIBean 

i" 

4- — com.xis.leif .infobeans.DataltemsSinkUIBean 
±.~?pm.xi^ 

All Implemented Interfaces: 

Accessible, BeonContextChlldOwner, BeonContextChildOwnerDeleqator, BeanContextProxv. 
BeanContextServicesOwnerDeleaator . ClipboardUser , JDgtgltemSink, ImaaeObserver . MenuContainer . 
Serializable, StateSavable, UIBean 



public class ContentlnfoBean 
extends DataltemSinkUIBean 
implements ClipboardUser 

The ContentlnfoBean class is a visual component that displays the contents of a raw data item. If no contents are 
available, it defaults to a split pane containing the JAF menu and the PropertySheet of the raw data item. The contents 
may have be multipart, and may be text, html, rich text, or an image. Multimedia support will soon be added. 

Author: 

Jaime Garcia, Polexis, Inc 
See Also: 

Serialized Form 



Inner classes inherited from class javax.swing .JPanel 
JPaneLAccessibieJPanel 



Inner classes inherited from class iavax.swinq. JComponent 
JComponent.Acess?bleJComponent 



Inner classes inherited from class java.awt. Container 
Container.AccessibleAWrContainer 
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Inner classes inherited from class iova.Qwt. Component 
ComponentAccessibleAWTComponent 



Field Summary 


static TypedResourc 


RESOURCES 




localized resources for this view object. 



Fields inherited from class com.xis.ui .AbstractUIBean 
uibeanListener 



Relds inherited from class javax.swingJComponent 

accessibleContext, ListenerList, TOOL.TIP^TE^KEY, uj, 01|PllO9!Mi^ 



Fields inherited from class java.awt.Component 

BOnP^^GNMENT, CEM^AIJGNMENJ, LEH^AQGNMENT, raMr^GNMEM, TOP^U?NMENJ 



Fields inherited from interaface javQ.awtimQgeJmQgeOteeiyer 

ABORT, ALLBITSj ERROR, Fj^MEBHS, .HEIGHT, PROPERnK, SOMEBITS, WIDTH 



Constructor Summary 

ContentlnfoBean () 

Default constructor that creates an empty ContentlnfoBean. 



Method Summary 


void 


addRawDataltem (Object rawDataltem) 

Load the raw data item into the ContentlnfoBean. 


void 


addRawDataltems (Object R rawDataltems) 
Add the raw data items in the array. 


boolean 


canClear () 

Return true if the ContentlnfoBean has an object and it is selected 


boolean 


canClear (Object [] items) 

Return true if the specified items can be cleared. 


boolean 


canCopy () 

Return true if the ContentlnfoBean has an object and it is selected 


boolean 


canCopy (Object [1 items) 

Return true if the specified items can be copied. 


boolean 


canCut 0 

Return true if the ContentlnfoBean has an object and it is selected 


boolean 


canCut (Object |"1 items) 

Return true if the specified items can be cut. 


boolean 


canPaste () 

Return true if the ContentlnfoBean can paste new objects, false if not. 


boolean 


canSelectAll () 

Return true if the ContentlnfoBean can select all objects. 
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boolean 


canSelectNone () 

Return true if the ContentlnfoBean can un— select all objects. 


void 


clear () 

Mnflfw +ho rnntpn+TnfnRpnn tn rpmnvp thp rurrpnt rnw data item onlv if it is selected. 


void 


clear (Object [] items) 
Clears the given items. 


void 


clearAN () 

Removes the currently loaded object. 


boolean 


contains (Object [] items) 

Return true if this ContentlnfoBean contains all the objects of the given array. 


boolean 


containsComponent (Component component) 

Check if the given component is contained by this InfoBean 


void 


copy (Clipboard clipboard) 

Called to invoke this ContentlnfoBean's copy action, which is to copy all selected data 
to the Clipboard. 


void 


copy (Clipboard clipboard, Object [] items) 
Copies the given items into the Clipboard. 


protected void 


createContent () 

Method called when there is no content to display for a raw data item. 


void 


cut (Clipboard clipboard) 

Cut selected items from the ContentlnfoBean and post them into Clipboard. 


void 


cut (Clipboard clipboard, Obiect \] items) 

Cut the given items from the ContentlnfoBean and post them into the given Clipboard 
only if they occur in the ContentlnfoBean. 


protected Container 


getContainerForContent ( int index) 

Get a container with the contents of the content object at the given index, or null if the 
content type is not supported. 


Object 


aetContents () 

Fetch the currently loaded raw data item 


JAFAndPropertyComponent 


getJAFAndPropertyComponent () 




Get the JAFAndProperty component used by the ContentlnfoBean to display the 
contents for raw data items that have nothing else to display. 


JMenu 


aetLeifDataltemMenu (LeifDataltem dataltem, boolean showCutPastltems) 

Return the data item menu for a LeifDataltem (usually the selected LeifDataltem). 


TypedResourceBundle 


getResources () 

Return the ResourceBundle for this ContentlnfoBean. 


Object () 


qetSelectedObjects () 

Get an array of selcted objects. 


Void 


infoModelChanged () 

Messaged to indicate an InfoModel change for this InfoBean or one or more of its 
LeifDataltems. 


boolean 


isCreatingContent () 

Check whether default content creation is set. 


boolean 


isDragEnabled () 

Return true if the default Drag support is enabled. 


boolean 


isDropEnabled () 

Return true if the default Drop support is enabled. 
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boolean 


isSelected () 






LriiecK tne seiectea state ot tne conient oDject, it inere is currenuy one iuuucu. 




boolean 


isXISNotifying () 

Phorlf whpfhpr thp rnntpntTnfnRpnn undatina bosed on XIS events and is notifvina 
XIS of raw data item attribute changes 




void 


paste ^uiipDoura ciipuoaray 

Paste the data Objects from the given clipboard. 




void 


removeAHKawuataitems \j 

Remove all of the raw items that are currently loaded 




void 


removeRawDataltem (Object rawDataltemj 

Remove the given raw data item if it is the currently loaded raw data item 




void 


removeRawDataltems (Object [] rawDataltems) 

Remove the given raw data items in the array. 




void 


seJectWI.() 






Set the selection state of the object to true. 




void 


selectNone () 






Set the selection state of the object to false. 


] U 


void 


setCreateContent (boolean create) 

Set whether content should be created for objects that do not have any displayable 
content, via a JAFAndPropertyComponent. 


.ssss. 


void 


setDragEnabled (boolean enabledrag) 

Set the stratus of the default Drag support. 


: a 

•ST - 


void 


co+nrnrtn«/norPrrvw fHrnnOwnpr rlrnnProw 1 

Set the DragOwner "proxy" for this InfoBean. 




void 


setDropEnabled (boolean enabledrop) 

Set the status of the default Drop Support. 




void 


setDropOwnerProxy (DropOwner dropProxy) 

Set a DropOwner tt proxy" for this InfoBean. 




void 


setSelection (boolean selected) 

Set a selection state of the content object 




void 


setXISNotifying (boolean notify) 

Set whether ContentlnfoBean should update based on XIS events and should notify 
XIS of raw data item attribute changes 



Methods inherited from class com.xis.leif.infobeans.Da^ 

a d^MP.PPyJ.Pt9.r» S^RawQato addSeryice, close, 
cregteBegnCp^ dispose, getBegnContM?i: o . x y» 
getBeanContexS aeUnfoModej, getJ^Pppujators, 
gieEeSDgtjStem * gsiL^M^SmMfilQ.Mi getLeif DgtaltemMenu, getMenuBgr, 
getOwnedBegnCo^ getSeryic^ ptSeryice, getServjce, getStgtusggrs, getTqglBars, 
9?tSi.s, in]tiaj[zeBegnC^ jntiaiizeBegnCon 
inyajidgteM LsDrpp^ isHgndiingCiipto^^ 
rejegseBe„gnCpntexjResp reJegseBegnCgnte^ reyokeAnchpredDjaJogP 
reypkeFrgmePro^^ reygkeSeryice^ setDrppPastelnabledj setHgndiingCljpbpgrdOpe 
voW 



Methods inherited from class com.xis.ui.Absto 

addUIBeanList^ finalize, getShprtTltle, getTitle, geM??.nDP.9Pe.0.ts. jstetive^ 
isC'tosed'r isCioseOK,^ proq»s^^gnEven^ H rempyeUIBegnys^ restoreState, sweStqte, 
sejActjye, setShojifjtle, setTltle 



FIG. 33D 



Title: Extensible Information System (XIS) 
Inventors: R. Kadel et al. 
Appl.No.: 10/039,306 -Filed: 10/22/01 
54/90 



Methods inherited from class javQX.swing JPanel 
getAccessibleContext, getUIClassID, paramString , updateUI 



Methods inherited from class javax.swing JComponent 

addAncestorListener, addNotify, addPropertyChangeListener, addPropertyChangerListener, 

gMefogbleChgngeXi^ compuMsiMef?ect contains, creaMp.pffip, disable, enable, 

firePrgpertyChgnge, firePropertyChange, fire^rp^.ertyChange, firePrppe.r^Chang.e, 
fePrpp.e„r}yChgnge J firePrppertyChange, fte£rpp.e.ri)^EQD.ge., "fkePmp^HyCha.n.g^ 
firePrpp.ertyChange, fireVetgabJeChange, gie^cjtipnFprKeySirpke, setActjonmag, 
geMgnmenW, geiAlignmentY, geWutpscrgjis, getBprder, .getBpunds, sdG!ientPrppertXi 
getCgmppnentGrgphics getCpndifipnFgrK^ a,etDej?upG^ getGraphjcs, 

getHeighi geUnputMap., getjnputMgp, geQnputYenfier, getjnsets, getinsete, 
getDsteners, geiLocgtibn, a?tRP5<&-U(D.5.!ze, Seffiffi getNextF; pcusableCom 
SetPrefeFedSize getRe^ adRPPtPaDii 'getSizej' getfp^ 

g.etTppJj!pText, gettppjllplext, getfppLeyejAncestpr, getVenfylnputWhenFoc 
^eMsjbjeRect, getWjdth, ' getX, getY, grgbFocus, hgsFqcus, Hide, isDpu£leBuffered, 
isFpcusCycieRopt, jsFocusTr^ isUghtwejghtC^^^ isMqnggjng£^ 

isMgx|murnSfe isMinimumSizeSet, isOpggue, isQptimizedDrawin isPajntingTiJe, 

isPreferredSjzeSet, isReguestFpcusEngMed, isYgJidgteRppX paint pamtBprder* 
paintChildren, paintCoirippnent, paintlmmedigtely, pgjnOmmedigtely, print, p.rintAII, 
P.rintBorder, ^nntChiJdren, printCpmppnent, pxpcessjCpmppn^ prpcesS 
RrpcessKeyBjnJ^ prpcessKeyEyeft prpcessMpuseMpt^ pMCJieMPrpperty, 
registerKeybpgrdActipn, resMerKeybpaxd^ctign, rempyeAncestprUstener, remoyeNptify, 
rermyeP^ remgy^^ krnpye^ 

repaint, repaint, reguestDefaujtFpcuSj repuestFpcys, resetKeybpardActipns, reshape, 
revalidate, scrpJJRectTp^sjble, setActjpnMa^ setAlignmentX, setAjignmentY, 
seUutpscrp!)s, s^gckgrpund, setBprdef, setDebug.^ setDpubjeBufffer 
§st£npt?k4 se.tFp.nt s„e.ttoegrouad, setioputMgp, s.eEnputYgrifi.e.r, ^iMflximum^iz^ 
setMi mm u mSize, setNextFgcusg WeCom ppnenjt, setOpapue, setPref erredSize, 
setRegu.es^ setfoplfipfext, setUI, setVerifylnputWh^ setVisjbJe, 

ynregjsiexK^ update 



Methods inherited from class java.awt. Container 



add, gdd, add, add, add, gddCpntgjnerListener, gddlmp.L cpuntCpmppnents, deJlyerEyent, 
dpLgyput, findCpmppnentAt, fjndCpmppnentAt, getCpmppnent, getCpmppnentAt, ajS^^zisQnMMi. 
getCpmppnenfQpuni getQpmppn.e.at§, geEoyput iaieS, fiyplidgte, iSSiferOt layout 
list list locate, minimumSjze, pgintCpmponents, preferredSize, pnntCpmDOMnfe 
RCPcessCpntginerEyent^ prpcessEvent, remove, remove, rempyeAII, remove^ 
setLgyput, .validate, vajidateTree 



Methods inherited from class java. a wt Component 

g.Q.tig.n, .add, .QddCpmp.QirentLfete.rAer, gddEQ.QusLfete.ne.r, gddHi.exQ.rQbyBpu.nd.slisteo.er, 
g.ddHi.exg.CQbyUsie.ne.r, .QdciInp.u!;M.e.th.QdU.stene.G addKeyLfeteaer, addMpyseListener, 

addMouseMptigDlistener, bpun.ds., .QbecMrnp.ge, Qh.epldmQge, cpaJesceEyents, contains, 

creaMmgge, pxe.QteImp.ge, disj.bieEy.ents., dispptghEyeat e.a.Qb!e, enQS£y.e.n.te, 
e.nabJelnp.ytMethpdSj getBgckgrpund, getBpunds, getCgJorMpdel, getjCpmppnentOrientatipn, 
getCurspr, gejpropTgrget, getFpnt, g^FpntMetncs, aetFpregrpund, 
getGrgp^^^ geffipg'E.Qntjext .gjffip.ul^^^^ getlpcpje., 

getLpcatipn, getLpcatipnOnScreen, getNqme, getPgrent getPeer, getSize, getlppJKit 
SeffreeLpck, SLptFpcus, bandJeEyent, imageUpdate, inside, isDjspJaygbje, isEngbled, 
AsLiphtweig.ht, isShpwing, isVglid, jsVtsible, ke^Down, keyUp, list, list list [pcatign, 
LpstFpcus, mpuseDpwn, mpuseprgg, mpuseEnter, mpuseExit, mpuseMpye, mpuseOp., .move, 
neitFocus, pgintAjL ppsiEyent, prepaMmage^ pre.pQrpImgjg.e, prppe5§CpmP.P.S 
p.r.PcessHiergrchyBpundsEyent, pxpcessHierarcby£yent pXppessInputMetb.QdEyent 
P.f pcessMpuse Event remove^. rempyeCpmpp^ rempyefpcy sListeneL. 

remoyeHiergrchyBpundsDste rempyeHiergrc%Usiener, .rempyelnputMethM 
rempyeKeyDstener, rempyeMpuseDstener^ rempyejMpusel^tipnQ repaint repaint 

repaint, resize, resize, setBpunds, setBpunds, §eiCp.mpp.DjB^iOji§DtQ.UQ]L s.et.Cyrspx, 
s^etDrppJarget, setLpcgle, setLpcatipn, setLpcatipn, setNgme, setSize, setSize, show, 
shpv/' size, tpString, trgnsferFpcus 
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Methods inherited from calss java.lang.Object 

clone, equals , qetClass , hoshCode , notify , notifyAII , wait , wait wait 



Methods inherited from interface com.xis.ui. ClipboardUser 
isHandlinaClipbocrdOperations . setHandlinqClipboardQperations 



Methods inherited from interface conmxis.uL UIBean 
addPropertvChanaeListener . removePropertyChanqeListener 



Field Detail 



RESOURCES 

public static final TypedResourceBundle RESOURCES 
localized resources for this view object. 



Constructor Detail 



ContentlnfoBean 

public ContentlnfoBean () 

Default constructor that creates an empty ContentlnfoBean. 



Method Detai 



getContents 

public Object getContents () 

Fetch the curently loaded raw data item 
Returns: 

the currently loaded object, or null if no object is loaded 



setXISNotifying 

public void setXISNotifying (boolean notify) 

Set whether the ContentlnfoBean should update based on XIS events and should notify XIS of raw data item 

attribute changes 

Parameters: 

notify - if true then notify XIS, else do not 
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isXISNotifying 

public boolean isXISNotifyingQ 

Check whether the ContentlnfoBean is updating based on XIS events and is notifying XIS of raw data item 

attribute changes 

Returns: 

true if it is notifying XIS, else false 



removeAIIRawDataltems 

public void removeAHRawDataItems() 

Remove all of the raw data itmes that are currently loaded 



getResources 

public TypedResourceBundle getResourcesQ 

Return the ResourceBundle for this ContentlnfoBean.. 
Overrides: 

getResources in class DataltemSinkUIBean 
Returns: 

the statically sourced ResourceBundle. 



infoModelChanged 

public void infoModelChangedQ 

Messaged to indicate an InfoModel change for this InfoBean or one or more of its LeifDataltems. This should 

reload all currently loaded data items to pick up InfoModel changes. 

Overrides: 

infoModelChanged in class DataltemSinkUIBean 



addRawDataltems 

public void addRawDataItems(Object() rawDataltems) 

Add the raw data items in the array. Will only add if the array has only one object and the object is not the 

currently loaded rawDataltem. 

Parameters: 

rawDataltems-the array of objects to be added 



addRawDataltem 

public void addRawDataItem(Object rawDataltem) 
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Load the raw data item into the ContentlnofBean. If the raw data item supports the ContentDomain and has 
content of type that is currently supported then it will be displayed. Otherwise, if content creation is set to true then 
default content will be created, using a JAFAndPropertyComponent 
Overrides: 

addRawDataltem in class DataltemSinkUIBean 
Parameters: 

rawDataltem-the raw object to display 



createContent 

Protected void createContent () 

Method called when there is no content to display for a raw data item. The default behavior displays a 
JAFAndPropertyComponent of the object, but subclasses may wish to display something else instead. 



isCreatingContent 

public boolean isCreatingContent() 

Check whether default content creation is set. If so then a JAFAndPropertyComponent will be created for items 

that have no displayable content. 

Returns: 

true if default content is created, else false 



setCreateContent 

public void setCreateContent(boolean create) 

Set whether content should be created for objects that do not have any displayable content, via a 

JAFAndPropertyComponent. 

Parameters: 

create-if true, create content, else do not 



removeRawDataltems 

public void remove Raw Da taltems (Object () rawDataltems) 



Remove the raw data items in the array. Will only remove the object that is currently loaded if it is contained in the 
array 

Parameters: 

rawDataltems-the array of objects to be removed 



removeRawDataltem 

public void removeRawDataltem (Object rawDataltem) 
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Remove the given raw data item if it is the currently loaded raw data item 
Overrides: 

removeRawDataltem in class DataltemSinkUIBean 
Parameters: 

rawDataltem-the object to remove 



getJAFAndPropertyComponent 

public JAFAndPropertyComponent get JAFAndPropertyComponentQ 

Get the JAFAndProperty component used by the ContentlnfoBean to display the contents for raw data items that 

have nothing else to display. 

Returns: 

the current JAFAndPropertyComponent being used 



getContainerForContent 

protected Container getContainerForContent(int index) 

Get a container with the contents of the content object at the given index, or null if the content type is not 

supported. Subclass this if you need support for a type that is not already supported. 

Parameters: 

index-the index of in the object 
Returns: 

a Container with the contents at the given index 



getSelectedObjects 

public Object () getSelectedObjects() 

Get an array of selected objects. This will return an empty array if there are no selected objects. If the raw data 

item is selected it will return an array of size 1 with the raw data item inside 

Returns: 

an array of selected objects 



isSelected 

public boolean isSelectedQ 

Check the selected state of the content object, if there is currently one loaded. If there is none, return false^. 
Returns: 

true if there is an object and it is selected 



selectAII 

public void selectAllQ 
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Set the selection state of the object to true. 
Specified by: 

selectAU in interface ClipboardUser 
Overrides: 

selectAU in class DataltemSinkUIBean 



selectNone 

public void selectNone() 

Set the selection state of the object to false. 



setSelection 

public void setSetection(boolean selected) 

Set the selection state of the content object 
Parameters: 

the-new selection state 



canClear 

public boolean canClear() 

Return true if the ContentlnfoBean has an object and it is selected 
Specified by: 

canClear in interface ClipboardUser 
Overrides: 

canClear in class DataltemSinkUIBean 
Returns: 

true if the raw data item is selected 
See Also: 

getSelectedObjectsQ 



canClear 

public boolean canClear( Object () items) 

Return true if the specified items can be cleared. If the item is not in the ContentlnfoBean return false. If there 
more than one item return false. 
Specified by: 

canClear in interface ClipboardUser 
Overrides: 

canClear in class DataltemSinkUIBean 
Parameters: 

items-the Array of items to be cut. 
Returns: 

true if all of the items are present, otherwise false 
See Also: 
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contains(Object [] ) 



canCopy 

public boolean canCopyQ 

Return true if the ContentlnfoBean has an object and it is selected 
Specified by: 

canCopy in interface ClipboardUser 
Overrides: 

canCopy in class DataltemSinkUIBean 
Returns: 

true if the raw data item is selected 
See Also: 

canClear () 



canCopy 

public boolean canCopy( Object[] items) 

Return true if the specified items can be copied. If the item is not in the ContentlnfoBean return false. If there is 
more than one item return false. 
Specified by: 

canCopy in interface ClipboardUser 
Overrides: 

canCopy in class DataltemSinkUIBean 
Parameters: 

items-the Array of itmes to be cut. 
Returns: 

true if all of the items are present, otherwise false 
See Also: 

canClear(0bject [] ) 



canCut 

public boolean canCutQ 

Return true if the ContentlnfoBean has an object and it is selected 
Specified by: 

canCut in interface ClipboardUser 
Overrides: 

canCut in class DataltemSinkUIBean 
Returns: 

true if the raw data item is selected 
See Also: 

canClear Q 



canCut 

public boolean canCut( Object [] items) 
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Return true if the specified items can be cut. If the item is not in the ContentlnfoBean return false. If there Sis* 
more than one item return false. 
Specified by: 

canCut in interface ClipboardUser 
Overrides: 

canCut in class DataltemSinkUIBean 
Parameters: 

items-the Array of items to be cut. 
Returns: 

true if all of the items are present, otherwise false 
See Also: 

canClear(Object [] ) 



canPaste 

public boolean canPaste() 

Return true if the ContentlnfoBean can paste new objects, false if not. 
Specified by: 

canPaste in interface ClipboardUser 
Overrides: 

canPaste class DataltemSinkUIBean 
Returns: 

default is always true for the ContentlnfoBean. 



canSelectAli 

public boolean canSelectAHQ 

Return true if the ContentlnfoBean can select all objects. 
Specified by: 

canSelectAli in interface ClipboardUser 
Overrides: 

canSelectAli in class DataltemSinkUIBean 
Returns: 

returns true if there is an object and it is not selected 



canSelectNone 

public boolean canSelectNone() 

Return true if the ContentlnfoBean can un-select all objects. 
Returns: 

returns true if the raw data item is selected 



clear 

public void clearQ 
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Notify the ContentlnfoBean to remove the current raw data item only if it is selected. 
Specified by: 

clear in interface ClipboardUser 
Overrides: 

clear in class DataltemSinkUIBean 



clear 

public void clearf Obiect [] items) 

Clears the given items. These items only get cleared if they actually occur in the ContentlnfoBean. 
Specified by: 

clear in interface ClipboardUser 
Overrides: 

dear in class DataltemSinkUIBean 
Parameters: 

items-the items to cleared 



clearAII 

public void clearAll() 

Removes the currently loaded object. 



copy 

public void copy (Clipboard clipboard) 

Called to invoke theis ContentlnfoBean 's copy action, which is to copy all selected data to the Clipboard. 
Specified by: 

copy in interface ClipboardUser 
Overrides: 

copy in class DataltemSinkUIBean 
Parameters: 

clipboard-the Clipboard object that gets posted to. The actual items posted are contained in a 
LeifT ransf erable. 



copy 

public void copy( Clipboard clipboard, 
Object [] items) 

Copies the given items into the Clipboard. 
Specified by: 

copy in interface ClipboardUser 

Overrides: 

copy in class DataltemSinkUIBean 
Parameters: 

clipboard-the Clipboard object that gets posted to. The actual items posted are contained in a 
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LeifTransferable. 

items - the array of Object items to copied. 



cut 

public void cut( Clipboard clipboard) 

Cut selected items from the ContentlnfoBean and post them into Clipboard. 
Specified by: 

cut in interface ClipboardUser 

Overrides: 

cut in class DataltemSinkUIBean 
Parameters: 

clipboard-the Clipboard object that gets posted to. The actual items posted are contained in a 
LeifTransferable. 



cut 

public void cut( Clipboard clipboard, 
Object [] Items) 

Cut the given items from the ContentlnfoBean and post them into the given Clipboard only if they occur in the 

ContentlnfoBean. 

Specified by: 

cut in interface ClipboardUser 

Overrides: 

cut in class DataltemSinkUIBean 
Parameters: 

clipboard-the Clipboard object that gets posted to. The actual items posted are contained in a 
LeifTransferable. 

items - the array of Object item to cut and posted. 



paste 

public void paste ( Clipboard clipboard) 

Paste the data Objects from the given clipboard. This retrieves the clipboard contents and does a simple add. 
Specified by: 

paste in interface ClipboardUser 
Overrides: 

paste in class DataltemSinkUIBean 
Parameters: 

clipboard - the Clipboard that contains the objects. 
See also: 

addRawDataltems (Object [] ) 



contains 

public final boolean contains ( Object [] items) 
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Return true if this ContentlnfoBean contains all the objects of the given array. 
Parameters: 

items - an array of objects to locate in the ContentlnfoBean. 

Returns: 

true if there is only one object and ft is contained, false otherwise 



containsComponent 

public boolean containsComponent ( Component component) 

Check if the given component is contained by this InfoBean 
Parameters: 

component - the Component to check for 

Returns: 

true if it is contained, else false 



getLeifDataltemMenu 

public JMenu getLeifDataltemMenu fLeifDataltem dataltem, 

boolean showCutPasteltems) 

Return the data item menu for a LeifDataltem (usually the selected LeifDataltem). This is used by the menubar to 
add menuitems from this JMenu to a Data menu if there is exactly one DataltemSelected selected. 

Overrides: 

getLeifDataltemMenu in class DataltemStnkUIBean 
Parameters: 

dataltem - the LeifDataltem to get the menu for 

showCutPasteltems - true to allow cut and paste items to appear, false to omit them. 

Returns: 

the JMenu for the given LeifDataltem 



isDragEnabled 

public boolean isDragEnabled () 

Return true if the default Drag support enabled. 
Overrides: 

isDragEnabled In class DataltemsSin kUIBea n 

Returns: 

true if drag is enabled, false if not, default is initialized to true. 



setDragEnabled 

public void setDragEnabled (boolean enabledrag) 

Set the status of the default Drag support. 
Overrides: 

setDragEnabled in class DataltemSinkUIBean 
Parameters: 
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enabledrag - true if default drag support should be used, false if not. 



setDragOwnerProxy 

public void setDragOwnerProxy ( DragQwner dragProxy) 

Set a DragOwner " proxy " for this InfoBean. 
Overrides: 

setDragOwnerProxy in class DataltemSinkUIBean 
Parameters: 

dragProxy - a DragOwner implementation. 



isDropEnabled 

public boolean isDropEnabled () 

Return true if the default Drop support is enabled. 
Overrides: 

isDropEnabled in class DataltemSinkUIBean 

Returns: 

true if drag is enabled, false if not, default is initialized to true. 



setDropEnabled 

public void setDropEnabled (boolean enabledrop) 

Set the status of the default Drop support. 
Overrides: 

setDropEnable d in clas s DataltemSinkUIBean 
Parameters: 

enabledrop - true if default drag support should be used, false if not. 



setDropOwnerProxy 

public void setDropOwnerProxy ( DropOwner dropProxy) 

Set a DropOwner "proxy" for this InfoBean. 
Overrides: 

setDropOwnerProxy in class D ataltemSinkUIBean 
Parameters: 

dropProxy - a DropOwner implementation. 
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Package com.xis.leif.im 



This package contains classes that provides the APIs for using information management in applications. 
See: 

Description 



Interface Summary 


Attribute 


The Attribute class represents an attribute for a particular data type. 


AttributeAlias 


The AttributeAlias indicates an alias from Ln Attributes to a single Attribute, together 
with a precision level; the higher the precision, the better the alias. 


AttributeFactory 


The AttributeFactory class allows an implementor to return an appropriate Attribute for 
the given LeifDataltem. 


AttributeLookup 


The AttributeLookup interface is used to lookup Attribute objects for a particular data 
item. 


DisplayLabel 


The DisplayLabel Interface defines methods that are needed for use with 
DisplayLabelAttributes. 


Domain 


This interface describes the basic fields and methods possessed by all Domains. 


InfoModel 


The InfoModel interface is the interface that is used to convert raw data items into 
LeifDataltems. 


LeifDataltem 


The LeifDataltem interface represents a simple data item. 


LeifDataltemObserver 


This class is used for observing a LeifDataltem to know when it has finished processing an 
action. 


UteDataltem 


The LiteDataltem interface represents a data item. 


PropertyProvider 


If a PropertyProvider implementation is added to services it can be used to replace the 
standard behavior when a PropertySheetView is opened from a JAF menu or as a default 
command. 


RawDataltemLookup 


The RawDataltemLookup interface is used to look up a raw data item from a unique id. 



Class Summary 


AbstractAttribute 


The AbstractAttribute class represents an Attribute. 




This register AttributeAliases. 


AttributeDescriptor 


The AttributeDescriptor class is used to describe an 
attribute without providing functionality of how to use the 
attribute. 




The AttributeDescriptorFactory class is a singleton 
class used to create or qet AttributeDescriptors. 




The AttributeFactorylnfoModelSubset class 
provides an InfoModel that will add the Attributes specified 
by the AttributeFactories to all LeifDataltems this 
InfoModel creates. 



FIG. 34A 



Title: Extensible Information System (XIS) 
Inventors: R. Kadel et al. 
Appl.No.: 10/039,306 -Filed: 10/22/01 
67/90 

FIG. 34B 



AttributeGetRequest 


The AttributeGetRequest class is used to package ail 

It L £ .Li* I! 1 XA *l_ 1. 

the necessary parameters for getting the value an attribute. 


AttributeLockRequest 


The AttributeLockRequest class bundles attributes 
needed to gain access to locked LeifDataltems, 


Attributes 


The Attributes is a container for holding attributes. 


AttributeSetRequest 


The AttributeSetRequest class is used to package all 
the necessary parameters for setting an attribute. 


BaseDataltem 


The BaseDataltem is the first wrapper around raw data 
items. 


BaselnfoModel 


//PENDING(RK): Any method marked with " PENDING " in 
the JavaDoc will//likely be removed before XIS is released 
in final form. 


BaselnfoModelServicesProvider 


The BaselnfoModelServicesProvider class will 

provide all the services available from the BaselnfoModel 

to the given BeanContextServices object. 


Collection Properties 


This class populates JAFMenus for generic collections. 


DataltemActionManaqer 


The DataltemActionManager class provides some useful 
static methods for dealing with actions on LeifDataltems. 


DataltemActionManaqer.LeifReferenceActionListener 


This class is an actionUstener to be used with 
LeifReference " Load " menus. 




DataltemMenuSet 


The DataltemMenuSet class is used by the 
LeifJAFUtilities class to return essentially a Dataltem 
popup menu with annotation. 


DataltemMenuSetEntry 


The DataltemMenuSetEntry class encapsulates a 
Dataltem and it's menu, and also provides some 
convenience methods for adding additional menu items. 


DefaultWrapperAttribute 


The DefaultWrapperAttribute class is a generic 

attribute that is the superclass of all defaults in generated 

domain attributes. 


DisplayLabelAttribute 


The DisplayLabelAttribute class is used to display j 
one or more Attribute values in conjunction with string 
literals specified by users. 


DisplayLabelData 


The DisplayLabelData class is used by the 
DisplayLabelAttribute to store a mapping of 
LeifDataltems to DisplayLabelTemplates. 


DisplayLabelTemplate 


The DisplayLabelTemplate class is used by the 
DisplayLabelAttribute to compute and store editing 
and rendering values for every LeifDataltem that has the 
attribute. 


DomainMethod 


Abstractly represents a Domain Method. 


DomainMethodDescriptor 


The DomainMethodDescriptor class is used to describe j 
a DomainMethod. 


DomainMethodDescriptorFactory 


The DomainMethodDescriptorFactory class is a 
singleton class used to create or get 
DomainMethodDescriptors. 


DomainWrapper 


This class adds methods to LeifDataltem delegator that are 
useful in the domain wrappers. 


DynamicAttributes 


The DynamicAttributes class is used for storing 
dynamic attributes. 
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FieldMetaData 


FieldMetaData specifies sorting and subset criteria for an 
attribute. 


FieldMetaDatas 


The FieldMetaDatas class represents a collection of 
FieldMetaData for a data item. 


TnfnMnripinntnTtpm 


The InfoModelDataltem allows views to wrap 
LeifDataltems and add/remove/modify attributes that will 
only affect that view. 


InfoModelSubset 


Typically when creating an InfoModel to nest within an 
existing InfoModel, which is done by VlewUIBeans, an 
InfoModelSubset is used. 


InvalidWrapperAttribute 


The InvalidWrapperAttribute class 


LeifDataltemComparator 


The LeifDataltemComparator compares LeifDataltems by 
AttributeDescriptor supplied by the user. 


LeifDataltemDeleqator 


Implements the methods in LeifDataltem in a wraDDer so 
you don't have to. 


LeifDataltemSorter 


The LeifDataltemSorter provides a default sorting tool for 
all LEEF LeifDataltem objects. 


LeifDataltemUpdate 


This classes is used with the LeifDataltemObserver. 


Leiflnitialization 


The Leiflnitialization class handles some standard 
initialization for most XIS Applications. 


LeifJAFUtilities 


-1-1 • 'fun li'l'l* 1 XI - L X' 

The LeifJAFUtilities class provides some useful static 
methods for Leif-related JavaBeans Activation Framework 
(JAF) processing. 


LeifJAFUtilitiesleifReferenceActionListener 


This class is an actionListener to be used with 
LeifReference * Load " menus. 


Leif Request 


The LeifRequest class is used to package all the 

nACPQQnrv nnmmptAfQ for renue^tinn informnHon for <i 

LeifDataltem. 


LeifTransaction 


The LeifTransaction class is used to construct a 
transaction. 


LockedLeifDataltem 


The LockedLeifDataltem class is used to enable locking 
on the data item. 


MethodRequest 


The MethodRequest class is used to package all the 
necessary parameters for invoking a DomainMethod for a 
LeifDataltem. 


MutableAttributeDescriptor 


Mutable subclass of AttributeDescriptor. 


ObserverSupport 


This class provides useful support for using the 
LeifDataltemObserver. 


RequestPool 


The RequestPool class is used to to assist Object pooling. 


Resources 


The Resources class is automatically generated and must 
be public, but it is intended to be used only by Java's 
internationalization support classes. 


SelectableDataltem 


Creates a wrapper around a LeifDataltem for a 
SelectablelnfoModel. 


SelectablelnfoModel 


Manages selections for the selectable leif data items that are 
contained within this model. 


Translator 


A major design goal for XIS was to provide the ability to 
integrate existing data item classes without modifying them. 
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TranslatorReqistry 


Provides a central location for maintaining Translators, 
extended Translators and locating Domain methods on data 
Items. 


UndefinedAttribute 


The UndefinedAttribute class represents an undefined 
attributes. 


VisibilityAttribute 


The VisibilityAttribute class is an Attribute that is 
ready to use for LeifDataltem visibility. 



Exception Summary 


DataltemNotFoundException 


The DataltemNotFoundException class is an exception that can be thrown 
when trying to look up a data item from an id 


InvalidObiectSchemaException 


Signals that there was a problem with the creation or modification of an 
ObjectSchema. 


TranslatorException 


The TranslatorException class 


UnconvertibleAliasException 


Indicates that the requested attribute alias could not be calculated or converted. 


UndefinedLeifAttributeException 


Indicates that the requested attribute is not applicable for the object. 


UndefinedLeifMethodException 


The UndefinedLeifMethodException class indicates that the data item does not 
define the method. 


UnremovableAttributeException 


The UnremovableAttributeException class indicates an attempt to remove an 
Attribute that was defined by the raw data item (either by reflection or a 
Translator.) Only additional Attributes added to LeifDataltems can be removed. 
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com.xis.leif.im 

Interface InfoModel 

All Superinterfaces: 

BeanContextChildOwner , BeanContextChildQwnerDeleqator , BeanContextProxy 

All Known Implementing Classes: 
InfoModelSubset 



public interface InfoModel 

extends BeanContextChildOwnerDeleqator 

The InfoModel interface is the interface that is used to convert raw data items into LeifDataltems. The InfoModel should 
hold each of these LeifDataltems created using weak references so that the data items can be cleaned up when they are no 
longer being used. //PENDING(RK): Any method marked with " PENDING " in the JavaDoc will likely be removed 
before LBF is released in final form. 

Since: 

LE3F 4.0 
Version: 

$Revision: 1.20 $, $Date: 2001/08/17 00:54:54 % 
Author: 

David Almilli 



Method Summary I 


void 


activateOneOfNService (Object service) 

//PENDING(RK): This method will probably be removed from InfoModel! Notify the InfoModel 
that the given service is the preferred service of its type, and that this particular object should be returned 
if its class is requested, until removed or until another object of the same type is passed to a future call to 
this method. 


void 


addlnfoModelUstener (InfoModelListener listener) 

Adds a listener to this InfoModel so that the listener will be informed of changes to the InfoModel. 


void 


addOneOfNService (Object service) 

//PENDING(RK): This method will probably be removed from InfoModel! Add an object as a 
service to be retrieved by a call to getService() (via BeanContext APIs) on any class that this object 
implements or extends. 


void 


clearSelection 0 

Clears the selection. 


LeifDataltem 

[] 


dump () 

Gives a list of all the LeifDataltems currently in the InfoModel. i 


EzContext 


qetEzContent 0 

Gets an EZ Context that corresponds to this InfoModel so the developer can use the EZ APIs. 
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LeifDataltem 


qetLeifDataltem (lonq uid) 

This will attempt to lookup a LeifDataltem from an id. 


LeifDataltem 


qetLeifDataltem (Obiect rawDataltem) 

This will wrap a raw java Object with a LeifDataltem wrapper so you can use it in leif as a data 

item. 


LeifDataltem 


qetLeifDataltem (Object rawDataltem, boolean create) 

This will wrap a raw java Object with a LeifDataltem wrapper so you can use it in leif as a data 

item. 


LeifDataltem 

[] 


qetLeifDataltems (Object 11 rawDataltems) 

This convience method will wrap an array of raw java Objects with LeifDataltem wrappers so 
you can use them in leif as LeifDataltem s. 


InfoModel 


getParentlnfoModel () 

Provides access to the parent InfoModel that this InfoModel delegates to. 


Object [] 


qetSelectedRawDataltems 0 

Gets the list of all the currently selected items for this InfoModel 


Obiect 


qetSinqleSelectedltem 0 

Get the selected raw data item, if only one. 


ViewHost 


getViewHost () 

Gets the ViewHost that this InfoModel is associated with. 


void 


removelnfoModelListener (InfoModel Listener listener) 

Removes a listener from this InfoModel so that the listener will no longer be informed of changes 
to the InfoModel. 


void 


removeOneOfNService (Object service) ' 

//PENDING(RK): This method will probably be removed from InfoModel! Remove an object that 
was a service to be retrieved by a call to getService () (via BeanContext APIs) on any class that this 
object implements or extends. 



Methods inherited from interface com.xis.beoncontext BeanContextChildOwnerDeleqator 
initianzeBeanContextResources , releaseBeanContextResources 



Methods inherited from interface com.xis.beans.beancontext. BeanContextChildOwner 
qetOwnedBeanContextChild 



Methods inherited from interface iavq.beans.beancontext. BeanContextProxy 
qetOwnedBeanContextChild 



Method Detail 



getLeifDataltem 

public LeifDataltem getLeifDataltem (long uid) 

throws DotaltemNotFound Exception 

This will attempt to lookup a LeifDataltem from an id. If the UID is invalid or there isn't a LeifDataltem that 

already exists with that given UID, an exception will be thrown. 

Parameters: 

uid - the inique id for the raw data item. 

Returns: 
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the LeifDataltem with the given UID 



getLeifDataltem 

public LeifDataltem getLeifDataltem ( Object rawDataltem) 

This will wrap a raw java Object with a LeifDataltem wrapper so you can use it in leif as a data item. 
Parameters: 

rawDataltem - the raw data that will be wrapped. (Note: this should not already be a LeifDataltem) 

Returns: 

the wrapped data item. 



getLeifDataltem 

public LeifDataltem getLeifDataltem ( Object rawDataltem, 

boolean create) 

This will wrap a raw java Object with a LeifDataltem wrapper so you can use it in leif as a data item. 
Parameters: 

rawDataltem - the raw data that will be wrapped. (Note: this should not already be a LeifDataltem) 
create - if false and the LeifDataltem is not already in the model, don't create one and return null 

Returns: 

the wrapped data item, or null if "create" is false and not found 



getLeifDataltems 

public LeifDataltem [] getLeifDataltems ( Object [] rawDataltems) 

This convenience method will wrap an array of raw java Objects with LeifDataltem wrappers so you can use them 
in leif as LeifDataltems. Note that you can get an array of raw data items often from methods like getMembers(), 
so this is a useful method to have. 
Parameters: 

rawDataltems - the raw data objects that will be wrapped. (Note: the objects should not already be 
LeifDataltems) 

Returns: 

the corresponding wrapped data item array. 



getEzContext 

public EzContext getEzContext () 

Gets an EZ Context that corresponds to this InfoModel so the developer can use the EZ APIs. 
Returns: 

the ez context for this info model 



getSingleSelectedltem 

public Object getSingleSelectedltem () 
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Get the selected raw data item, if only one. Else return null. 
Returns: 

the selected item if there is only one. 



getParentlnfoModel 

public InfoModel getParentlnfoModel () 

Provides access to the parent InfoModel that this InfoModel delegates to. If there is no parent model then this will 

return null. 

Returns: 

the parent InfoModel 

clearSelection 

public void clearSelection () 
Clears the selection. 



getSelectedRawDataltems 

public Object [] getSelectedRawDataltems () 

Gets the list of alt the currently selected items for this InfoModel 
Returns: 

all of the selected data items (as raw data items) 



activateOneOfNService 

public void activateOneOfNService ( Object service) 

//PENDING(RK): This method will probably be removed from InfoModel! Notify the InfoModel that the given 

service is the preferred service of its type, and that this particular object should be returned if its class is requested, 

until removed or until another object of the same type is passed to a future call to this method. 

Parameters; 

service - the object to become the preferred service 
addOneOfNService 

public void addOneOfNService ( Object service) 

//PENDING(RK): This method will probably be removed from InfoModel! Add an object as a service to be 
retrieved by a call to getServiceO (via BeanContext APIs) on any class that this object implements or extends. 

Parameters; 

service - the object to be returned when requested 
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removeOneOfNService 

public void removeOneOfNService ( Object service) 

//PENDING(RK): This method will probably be removed from InfoModell Removed an object that was a service to 
be retrieved by a call to getServiceQ (via BeanContext APIs) on any class that this object implements or extends. 
Parameters: 

service - the object to be removed from service 



getViewHost 

public ViewHost getViewHost Q 

Gets the ViewHost that this InfoModel is associated with. If this InfoModel is not associated with a ViewHost then 

this will return null. 

Returns: 

the view host that is maintaining this InfoModel. 



addlnfoModelListener 

public void addlnfoModelListener ( InfoModelListener listener) 

Adds a listener to this InfoModel so that the listener will be informed of changes to the InfoModel. 
Parameters: 

listener - the listener to add 



removelnfoModelListener 

public void removelnfoModelListener ( InfoModelListener listener) 

Removes a listener from this InfoModel so that the listener will no longer be informed of changes to the 
InfoModel. 

Parameters: 

listener - the listener to remove 



dump 

public LeifDataltem [] dumpQ 

Gives a list of all the LeifDataltems currently in the InfoModel. It is highly recommended to use this method only 
if you absolutely have no other way of accomplishing the task you need to do. Please keep in mind that if you hold 
onto the LeifDataltems contained in the array returned or if you hold onto the array itself, the items will not be 
removed from InfoModel until you release them. If you wish to hold onto them, you should wrap them in 
WeakReference objects. 

Note: When you use the dumpQ method in combination with the addlnfoModelListener so that you can keep track 
of the same set of LeifDataltems as the InfoModel, you can synchronize on the InfoModel to get the dump and 
then add a listener to receive events of future changes. 
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Example: 



synchronized(infoModel) \ 



v ~y> ' ^ aataitems.l 

processItem(dataItems[i]); 



n Returns: 



S See Alsl. ** * L « fD ^™ currently in the InfoModel. 

m WeokRefef^nce 
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Package com. xis.leif. event 



This package contains classes for handling events in XIS. 
See: 

Description 



Interface Summary 


InfoModelListener 


The InfoModelListener is used to monitor changes to an InfoModel. 


LeifDataltemListener 


This class is used for listening to LeifDataltems for various events. 



Class Summary 


AttnbuteChanqedtvent 


An * AttributeChanaed " pvpnt npta HpIivptpH whpnpvpr n Hnfn I+om 
changes an attribute value. 


ContainerAddedEvent 


A " ContainerAdded " event gets delivered whenever a data item is 
contained as a member in a new object. 


ContainerRemovedEvent 


A " ContainerRemoved " event gets delivered whenever a data item has 
been removed as a member from a containing object. 


DataltemRepiacedEvent 


The DataltemRepiacedEvent class is used to indicate member changes 
of a containing data item. 


InfoModelEvent 


The InfoModelEvent gets delivered whenever a LeifDataltem is created 
by the InfoModel, or when a LeifDataltem has been " lost " by the 
InfoModel. 


InfoModelEvenSupport 


The InfoModelEvenSupport support class provides basic support for 
managing listeners on an InfoModel. 


LeifDataltemAdapter 


The LeifDataltemAdapter class provides support for setting up a 
LeifDataltemListener on a data item. 


LeifEvenSupport 


This is a utility class for XIS developers to use when they want to fire 
event changes. 


MemberAddedEvent 


The MemberAddedEvent class indicates that members were added to 
this data item. 


MemberEvent 


The MemberEvent class is used to indicate members changes of a 
containing data item. 


MemberRemovedEvent 


The MemberRemovedEvent class indicates members that the members 
are being removed from the containing data item. 


ReferenceAddedEvent 


The ReferenceAddedEvent class indicates that LeifReferences were 
added to the LeifDataltem. 


ReferenceEvent 


The ReferenceEvent class indicates changes to the LeifReferences of 
the data item. 
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ReferenceRemovedEvent 


The ReferenceRemovalEvent class indicates that LeifReferences were 
removed from the LeifDataltem. 


ReferrerAddedEvent 


The ReferrerAddedEvent class indicates that a Referrer was added to 
the data item. 


Ref erre rRe m oved Eve nt 


The ReferrerRemovedEvent calss indicates that a Referrer was 
removed from the data item. 



Package com. xis.leif. event Description 

This package contains classes for handling events in XIS. 
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LeifDataltem 



2 : property change event 



Individual objects can fire 
propertyChangeEvents, 
which LEIF Dataltems 
listen to. 



attributeChanged 
1 



Dataltems can also be 
changed using the 
LeifDataltem APIs or the 
DomainWrapper APIs 
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TestHarness.java 



I* XIS Tutorial standalone sequence example 5 XIS interfacing. */ 

import javax.swing.JFrame; 

import java.awt.event.WindowAdapter, 

import java.awt.event.WindowEvent; 
/*{*/ 

import ]ava.awt.GridLayout; 

import java.awtToolkit; 

import java.awtDimension; 

import java.awt.event.ComponentAdapter; 

import java.awt.event.ComponentEvent; 

import javax.swing.JSplitPane; 

import javax.swing.JComponent; 

/*}*/ 

import jclassxhart. JCChart; 

import com.xis.leif.im.BaselnfoModel; 

import com.xis.plot.PlotlnfoBean; 

import com.xis.plot.chartviews.LeifChartView- 
/*{*/ 

import com.xis.table.Tablel nfoBea n ; 
import com.xis.tree.TreelnfoBean; 
/*}*/ 

public class TestHarness { 

public static void main(StringQ args) { 

// the plugin manager is only required for more complex applications 
// involving multiple components integrated at runtime 
BaselnfoModel.setStartingPluglnManager(false); 

HelloWorld hellol = new HelloWorld ("First HeltoWortd object."); 
HelloWorld hello2 = new HeltoWorid("Second HelloWorld object."); 
HelloWorld hello3 = new HelloWorld('Third HelloWorld object."); 
HelloWorld hello4 = new Hel!oWorid("Fourth HelloWorld object."); 
HelloWorld hello5 = new HelloWorld("Fifth HelloWorid object."); 
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Continuation of TestHarness Java 



Object]] helloArray = new ObjectQ { hellot, hello2, hello3, he!lo4, 
helloS }; 

// create table and plot infobeans to display HelioWorid objects 
TablelnfoBean table = new TableInfoBean(); 

PlotlnfoBean plot = new PlotlnfoBean(); 
plotsetChartType(JCChartBAR); 

// the alternatives are SCATTER_PLOT, PLOT, AREA, PIE, CANDLE, 
// and STACKI NG_B AR, though not all will make sense in this example 

// We can set the attribute for initial display on the plot; 
// see step 3 for further comments. 
plotsetYAxisAttribute( 

f, com.xis.domains.movement.MovementDomain.speed M ); 
plotsetDynamicAdjustment(true); // so axes track value magnitude 
plotsetBarChartAdjusting(true); // needed in some cases for bar chart 



// a top-level frame as before to hold both plot and table side-by-side 
JFrame tablePlotFrame = new JFrame("HelloWorld(s) Table/Plot"); 
// use a repaired JSplitPane (see below) to manage the two beans 
SaneJSplitPane splitpane = new SaneJSplitPane(table,plot, 
new Dimension(tabIe.getPreferredSize().width + 
plotgetPreferredSize().width, 
Math.min(table.getPreferredSize().height, 
plot.getPreferredSize().width)), 

0.50); 

tablePlotFrame.getContentPane().add(splitpane); 

tablePIotFrame.pack(); 

tablePIotFrame.setVisible(true); 

// a tree infobean to display our HelioWorid objects 
TreelnfoBean tree = new TreelnfoBean( M HelIoWorld(s) Tree"); 
tree.addRawDataltems(helloArray); 

// a top-level frame to hold our tree infobean 

JFrame treeFrame = new JFrame( w He!loWorld(s) Tree"); 
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Continuation of TestHarness.java 

// avoid placing the windows on top of one another if we can 
int cutoffHeight = 424; 

if (Toolkit.getDefauItToolkit().getScreenSize().getHeight() > 
cutoffHeight + 200) { 

treeFrame.setLocation(348,cutoffHeight+7); 

} 

7 

// add a listener for window closing 
treeFrame.addWindowListener( 
new WindowAdapter() { 

public void windowClosing(WindowEvent e) { 
System.exit(O); 

} 

} 

); 

// stick the tree infobean in the frame and display it 

treeFrame.getContentPaneQ.add(tree); 

treeFrame.packQ; 

treeFrame.setVisible(true); 

} // main 



/** 

* This class overrides the default JSplitPane to provide a reasonable 

* resize behavior: maintain the left and right panels in the same 

* proportions. 
7 

public static final class SaneJSplitPane extends JSplitPane { 

private int lastWidth; 
private double lastDividerProp; 

public SaneJSpIitPane(JComponent leftComponent, 
JComponent rightComponent, 
Dimension dims, double startProportion) { 
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Continuation of TestHarness.java 

super(JSplitPane.HORIZONTAL_SPLIT, 

leftComponent, rightComponent); 
setSize(dims); 

// Since the JSplitPane doesn't set the lastDividerLocation 

// variable, nor does it provide any other easier way to maintain 

// the split proportion on resize, we must track the divider 

// location ourself. 

lastWidth = dims.width; 

lastDividerProp = startProportion; 

setDividerLocation(startProportion); 

// this listens for resize events on the splitpane and makes sure 
// we keep same split proportions 
addComponentListener(new ComponentAdapter() { 

public void componentResized(ComponentEvent event) { 
setDividerLocation(IastDividerProp); 
lastWidth = (int)event.getComponent(). 
getSize().getWidth(); 

>}); 

// only way to know if divider moved by user is to listen for 
// resize events on the components; this isn't foolproof (since 
// resizes can come from other sources) but it works well enough 
leftComponentaddComponentListener(new ComponentAdapter() { 
public void componentResized(ComponentEvent event) { 
// we add in getDividerSize() / 4 to compensate for a 
// bug in JSplitPane which doesn't take account of the 
// divider width in location-proportion conversions 
lastDividerProp = (double)(getDividerLocation() + 
(getDividerSize() / 4)) / lastWidth; 

}}); 
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a>lHelloWorld(s) Tree □11][X 



□ HelloWorld(s) Tree 



®~ □ Rrst HelloWorld object. 
®" □ Second HelloWorld object. 
®~ □ Third HelloWorld object. 
®" □ Fourth HelloWorld object. 
°" □ Rfth HelloWorld object. 
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FIG. 39A 
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Method Summary 


AttributeDescriptor 
[] 


qetAliasedFrom Q 

This indicates which AttributeDescriptors (which in turns means which 
Attributes) are required for the alias. 


AttributeDescriptor 


qetAiiasedTo 0 

This indicates which AttributeDescriptor that this AttributeAlias is for. 


Attribute 


qetAttribute Q 

Get the Attribute object that is the alias Attribute. 


int 


qetPrecisionPriority 0 

This indicates the precision of the AttributeAlias. 



Method Detail 



getPrecisionPriority 

public int getPrecisionPriority () 

This indicates the precision of the AttributeAlias. The higher the number the better the alias. 

This number is used to determine which AttributeAlias to use when there are more than one 

alias for a given Attribute, 

Returns: 

the precision of the alias. 



getAliasedFrom 

public AttributeDescriptor [] getAliasedFrom () 

This indicates which AttributeDescriptors (which in turns means which Attributes) are required 

for the alias. 

Returns: 

the list of descriptors required for this alias. 



getAliasedTo 

public AttributeDescriptor getAliasedTo () 

This indicates which AttributeDescriptor that this AttributeAlias is for. 
Returns: 

the descriptor that this alias is for. 
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getAttribute 

public Attribute getAttribute() 

the attribute that will do the translation. 
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